home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Tips & Tricks for Windows 95 / Chip Wintips.iso / sharewar / online / wincode / readme.txt < prev    next >
Text File  |  1996-07-02  |  16KB  |  321 lines
  1.      Wincode: Multi-Purpose Encoder/Decoder for Windows
  2.               (C) _Snappy_ (1993-1996)
  3. ------------------------------------------------------------
  4.              written by George H. Silva
  5.  
  6.  
  7.      ***PLEASE DISTRIBUTE FREELY WITH ALL FILES INTACT***
  8.  
  9. Files:    WINCODE.EXE    the main executable program
  10.           WCENGINE.DLL   dynamic link library of coding functions
  11.           WCEHOOK.DLL    dynamic link library of menu hook functions
  12.           WCEFMEXT.DLL   File Manager Extension dynamic link library
  13.           WCHLPKEY.DLL   Help file option dynamic link library
  14.           WCESOCK.EXE    a companion Winsock e-mail/post daemon
  15.           WCEPADDR.WAB   default Wincode address book
  16.           WINSORT.EXE    a companion file-sort utility
  17.           UNINSTLL.EXE   Wincode package UnInstall program
  18.           ZIPLINK.EXE    executable link to PKZIP/PKUNZIP
  19.           ZIPLINK.PIF    ZIPLINK.EXE program information file
  20.           VSWLINK.EXE    Windows executable link to VSDLINK
  21.           VSDLINK.EXE    executable link to DOS Virus Scan software
  22.           VSDLINK.PIF    VSDLINK.EXE program information file
  23.           VSDLINK.DAT    VSDLINK Virus Scanner exit codes
  24.           MACAPPFC.DAT   MAC Finder information database
  25.           WCEDCSIG.DAT   Application information database
  26.           WCEMIME.DAT    MIME information database
  27.           SUM.EXE        a BONUS "sum -r/size" DOS utility
  28.           README.NOW     important info file
  29.           README.TXT     this file
  30.           HELPME.HLP     Wincode basics and information for obtaining
  31.                          the real HELP file (WINCODE.HLP)
  32.           LICENSE.TXT    _Snappy_ "User-Friendly" FREEWARE License
  33.           INSTALL.EXE    the Install/Upgrade program
  34.           INSTALL.HLP    the Installer HELP file
  35.           INSTALL.INF    the Installer information file
  36.           CHECKSUM.REF   checksum reference file
  37.           FILE_ID.DIZ    BBS identification file
  38.  
  39.         ****************************************************
  40.  
  41.         PLEASE SEE THE FOLLOWING FILES FOR MORE INFORMATION:
  42.  
  43.         README.NOW
  44.         HELPME.HLP (formerly HELPME.TXT -> now a Windows HELP file)
  45.         VSDLINK.DAT
  46.         LICENSE.TXT
  47.  
  48.         ****************************************************
  49.  
  50.  
  51. This file contains the following information:
  52.  
  53. I.    About Wincode
  54. II.   Wincode Features (very brief list! - MANY NEW FEATURES :-)
  55. III.  Coming Soon
  56. IV.   Requirements
  57. V.    Installing/Running/UnInstalling Wincode
  58. VI.   Availability
  59. VII.  Note to HELP Registered Users
  60. VIII. Copyrights
  61.  
  62.  
  63. NOTE: There is alot of helpful information in the file HELPME.HLP. You can
  64. now automatically access this file from Wincode by selecting any "Help"
  65. option (this file is now the "default help file" if you are not a registered
  66. user - if you are registered, this file is not needed since it duplicates
  67. portions of the *real* HELP file :-).
  68.  
  69.  
  70.  
  71. I. *** About Wincode ***
  72.  
  73. Wincode is a Windows 3.1x program which converts 8-bit BINARY (EXE, COM,GIF,
  74. etc) files to 7-bit ASCII (Text) files (and vice versa) through a process
  75. known as bit-shifting. Wincode currently supports UU/XX/USR/Base64 (MIME 1.0
  76. conformant), BINHEX, BTOA and BOO encoding/decoding. This BINARY/ASCII
  77. conversion allows you to send and receive binary files via e-mail or any
  78. other ascii-based communications system. It provides a quick and easy way to
  79. distribute programs to people all over the world (it takes a few minutes, on
  80. average, for e-mail to reach across the world). UUcoding is a common practice
  81. on many Internet NewsGroups in which users wish to exchange binary data. Base64
  82. coding is used by MIME (Multipurpose Internet Mail Extensions) conformant
  83. e-mail software as a method for attaching binary data to ascii e-mail. BINHEX
  84. is a popular encoding algorithm used mainly on Apple Macintosh computers. BTOA
  85. is a somewhat different variation of the common BINARY/ASCII conversion process
  86. which supports simple compression, several checksum options and will generally
  87. create encoded files that are smaller than other methods due to its conversion
  88. algorithm (mod 85). BOO is an older (extinct?) algorithm used in cross-platform
  89. file transfers that is provided for compatibility (it requires previous
  90. knowledge of decoded output filesize and may hence be unreliable). All these
  91. methods perform the same overall function (i.e. allow binary data to be safely
  92. transmitted through e-mail) but require different formatting algorithms (e.g.
  93. BINHEX supports Run-Length Encoding, BTOA uses mod 85 coding, etc).
  94.  
  95. Wincode and the associated executables and DLLs (NOT including the HELP file)
  96. are distributed as FREEWARE. However, we want to make a distinction: the
  97. program is FREEWARE, but it is NOT Public Domain. _Snappy_ still retains the
  98. Copyright to the source code and to the use and distribution of the program
  99. (see the file LICENSE.TXT). The HELP file is available for a small fee
  100. ($10.00 US) but is NOT required for Wincode to function correctly. Ordering
  101. the HELP file also entitles you to future updates and e-mail based support. The
  102. $10.00 fee is mainly to offset development costs and the amount of personal
  103. time invested. See below and the file HELPME.HLP for more information on
  104. obtaining support.
  105.  
  106. Wincode is 100% compatible with all standard UUcoders, MIME 1.0 conformant
  107. software, BINHEX 4.0 and BTOA v4.0 and v5.2 coders. The MIME (Base64) support
  108. was developed under the guidelines of RFC 1521 (September 1993) and is subject
  109. to our understanding of the document. The BINHEX support was developed under
  110. the guidelines of RFC 1741 (December 1994) and is subject to our understanding
  111. of the document. The BTOA v4.0 and v5.2 support was developed based on freely
  112. available documents by Paul Rutter, Joe Orost & Stefan Parmark (the creators
  113. of BTOA). We welcome all comments and error corrections. 
  114.  
  115. As part of our goal to support all BINARY/ASCII conversion methods in one
  116. (quality :-) product, Wincode now supports encoding/decoding of *seven*
  117. different formats. We have tried to incorporate as many extra features as
  118. possible to make the en/de-coding process painless. The average user may not
  119. need/use all of Wincode's features, but they *are* Free!
  120.  
  121. NOTE TO DEVELOPERS: WCENGINE.DLL contains ALL of Wincode's 'working' code
  122. (currently) accessed through 80+ functions/procedures. We created this SIMPLE
  123. interface to allow Developers to integrate the Wincode Engine into any
  124. program. We will provide the API and royalty free usage to interested
  125. developers under certain conditions. Please contact the _Snappy_ development
  126. team for more details:
  127.  
  128.    development@snappy.global2000.net
  129.  
  130.  
  131.  
  132. II. *** Wincode Features (very brief list!) ***
  133.  
  134.        - Full featured Windows 3.1 program
  135.        - Easy access ButtonBar for hassle-free operation
  136.        - Drag and Drop support (use for batch en/de-coding -> Wincode also
  137.          allows multi-file selection from File Open dialogs)
  138.        - SMART decoding (handles single files, multi-part files, can
  139.          determine what is encoded or not, etc. -> see the HELP file for
  140.          more information)
  141.        - Fully configurable...We're not joking!
  142.        - EMBL UUcode compatible
  143.        - Supports UU, XX or User defined En/De-coding
  144.        - Supports Base64 (MIME conformant) En/De-coding
  145.        - Supports BINHEX En/De-coding (with option to include MAC finder info
  146.          when encoding to make decoding on a MAC *very* easy!)
  147.        - Supports BTOA v4.0 and v5.2 En/De-coding
  148.        - Supports BOO En/De-coding
  149.        - Supports En/De-coding to/from the Clipboard!
  150.        - Supports automatic CODE TYPE detection (just use Auto Detect).
  151.        - Powerful Scripting language can be used to "program" Wincode
  152.          (includes new automatic "Repair" damaged files option!)
  153.        - Supports automatic ZIP/UNZIP (requires PKWare's ZIP/UNZIP 2.0)
  154.        - Supports automatic Virus Scanning (requires a DOS Virus Scanner -
  155.          see the VSDLINK.DAT file for more information)
  156.        - Application menu hooking option to integrate Wincode's menu
  157.        - Includes INSTALL program for upgrades
  158.        - Includes UNINSTALL program for removal
  159.        - Integrated file-sorting companion program (separate
  160.          executable for easier upgrading) which handles MANY types
  161.          of file header formats
  162.        - Integrated Winsock compatible e-mail/post daemon (separate
  163.          executable for easier upgrading) to allow for automatic e-mailing
  164.          and posting of encoded documents (see Requirements)
  165.        - Multimedia support - see the HELP file for details
  166.        - It's ALL FREE...
  167.  
  168.  
  169.  
  170. III. *** Coming Soon ***
  171.  
  172.        - 32-bit Win95/WinNT version. In progress but no date set yet. Keep
  173.          an eye on our HomePage for early BETAs...
  174.        - User suggestions...?
  175.  
  176.  
  177.  
  178. IV. *** Requirements ***
  179.  
  180.       - IBM compatible running DOS 3.3 or higher
  181.       - 286 or higher processor with at least 2MB memory
  182.       - Windows 3.1/3.11 running in standard or enhanced mode OR Win95
  183.       - About 1.7MB of disk space without HELP file (~2.0MB with HELP file)
  184.         (Sorry about the disk space - this should be reduced in the coming
  185.          months with the release of 32-bit version)
  186.       - ***NOTE*** To use Wincodes built-in E-Mail/Post capabilities, you
  187.         must have a Winsock setup. This means that you are using a Windows
  188.         Socket stack (WINSOCK.DLL) of some sort connected directly to the
  189.         internet (ethernet, SLIP, PPP, TwinSock, TIA, SLiRP, etc). The
  190.         E-Mail/Post Daemon is a Winsock v1.1 compatible app and has been
  191.         tested with Trumpet Winsock, SunSoft PCNFSPro Winsock, and Winsock
  192.         running under Win95. Improper or missing Winsock setup will only
  193.         result in harmless error messages :-)
  194.  
  195.  
  196.  
  197. V. *** Installing/Running/UnInstalling Wincode ***
  198.  
  199. If you have not already done so, expand the ZIP archive into a temporary
  200. directory (or a floppy-disk). Start Windows, select FILE|RUN from Program
  201. Manager or File Manager and type in the full path of the INSTALL.EXE program
  202. (run it). The INSTALL program will copy/expand all the files to a directory
  203. you specify (overwriting older files), upgrade your WINCODE.INI (if you are
  204. running an older version of Wincode) and create a Program Manager Group and/or
  205. icon. See the HELPME.HLP file for basic instructions on using Wincode.
  206.  
  207. ***IMPORTANT NOTES:
  208.    1) ALL files (listed above) must be present in the same directory for
  209.       Installer to function properly. You should INSTALL first, then move
  210.       selected files to directories of your choice (i.e. delete the README.TXT,
  211.       place SUM.EXE in your DOS directory, etc.). The install program uses the
  212.       Windows LZEXPAND.DLL to decompress and copy the required files. If you
  213.       receive any error messages during install, please contact _Snappy_ for
  214.       assistance.
  215.    2) If you receive a Program Manager DDE failure (usually under Windows95),
  216.       try RE-STARTING Windows. We have only observed this error under Win95
  217.       on computers that have been used extensively without restart. If this
  218.       fails, installation WILL proceed but PM Groups will not be created.
  219.  
  220. Wincode can now be un-installed in 2 easy steps. First, run Wincode and
  221. select 'Options|Configuration...' (CTRL-F) from the menu. You will see the
  222. configuration dialog which has an 'UnInstall...' button. Choose this to select
  223. the UnInstall method. The UnInstaller will remove/copy/list all files
  224. included in the Wincode package. However, it does NOT remove itself OR the
  225. directories that Wincode may have used. Therefore, the second step is to
  226. remove these directories and UNINSTLL.EXE from your drive. Wincode should now
  227. be completely erased from your drive.
  228.  
  229.  
  230.  
  231. VI. *** Availability ***
  232.  
  233. Recent versions of Wincode (or other _Snappy_ software) are always
  234. available at the following locations:
  235.  
  236.     - The Internet - the _Snappy_ Software site! All of our software is
  237.       available by three different methods:
  238.  
  239.       1) WWW forms - point your browser at: http://snappy.global2000.net/
  240.          and check out our HomePage! If you can't get through, try our
  241.          MIRROR site at: http://www.global2000.net/users/snappy/snappy/
  242.          (YES, there are two "snappy/" in the address! :-)
  243.  
  244.       2) Anonymous FTP - visit us at: snappy.global2000.net
  245.          MIRROR: www.global2000.net/users/snappy/
  246.  
  247.       3) Automated e-mail - send a request to our server and receive an
  248.          encoded copy by e-mail. Visit our HomePage for more info or send
  249.          a BLANK e-mail to: snappy@snappy.global2000.net for a TEXT copy
  250.          of our HomePage.
  251.  
  252.       In the future, we will try to establish mirror sites for our software.
  253.       Please visit our HomePage for recent developments...
  254.  
  255.     - CompuServe (check the WinShare forum; keyword: Snappy, Wincode, etc.)
  256.  
  257.     - America Online (keyword: Snappy, Wincode, etc.)
  258.  
  259.  
  260.       
  261. VII. *** Note to HELP Registered Users ***
  262.  
  263. If you are a registered user but have not received your HELP file, *please*
  264. contact us at: support@snappy.global2000.net with your registration info
  265. (name, address, e-mail address, etc). Many orders arrived with illegible
  266. and/or missing e-mail addresses. _Snappy_ uses your e-mail address as your
  267. user registration code. Further, some orders were shipped but *not received*.
  268. We can't track mail failures (we don't have the resources :-(  ) so we rely
  269. on customers to please get in touch with us if they have a problem.
  270.  
  271. Please note that registration is a ONE-TIME fee. In other words, your initial
  272. registration keeps you in our database to be eligible for future HELP file
  273. updates! However, it is up to YOU to keep us up to date with your registration
  274. info (e-mail address) and to request the HELP file updates from our server
  275. (this is now a built-in feature of Wincode).
  276.  
  277. If you need phone support, drop us an e-mail and we'll send you a contact
  278. number. This service is ONLY for registered users and calls are INCOMING ONLY.
  279.  
  280.  
  281.  
  282. XIV. *** Copyrights ***
  283.  
  284. Wincode is a TradeMark of _Snappy_ Software.
  285.  
  286. - portions of this program are copyright (C) 1983,1995 Borland
  287. - Windows is a trademark of Microsoft Corporation
  288. - PKZIP/UNZIP are copyright (C) 1989-1993 PKWARE Inc. All Rights Reserved.
  289. - GIF is a service mark of CompuServe Incorporated
  290. - WordPerfect is a registered trademark of Novell, Inc.
  291. - Procomm Plus for Windows is copyright (C) 1992-1993 Datastorm Technologies, Inc.
  292. - Star Trek: The Next Generation is a registered trademark of Paramount
  293.   Pictures
  294. - The Simpsons is trademark and copyright (C) Twentieth Century Fox Film
  295.   Corporation. All Rights Reserved.
  296. - Pinky and the Brain is copyright (C) Amblin Entertainment in association with
  297.   Warner Bros. Animation
  298. - DOOM is copyright (C) 1993 Id Software, Inc.
  299.  
  300. Copyrights or Trademarks referenced in any material accompanying this software but
  301. not mentioned above have been omitted in error. _Snappy_ observes and respects
  302. all copyrights and trademarks.
  303.  
  304.  
  305.  
  306. Have fun!
  307.  
  308. _Snappy_ Software ;-)
  309.  
  310.  
  311. _Snappy_ Info:  snappy@snappy.global2000.net
  312. Wincode Info:   wincode@snappy.global2000.net
  313. Bug Reports:    bugs@snappy.global2000.net
  314. FeedBack:       feedback@snappy.global2000.net
  315. HomePage:       http://snappy.global2000.net/
  316. MIRROR:         http://www.global2000.net/snappy/snappy/
  317.                (YES, there are two "snappy/" in the address! :-)
  318. --------------------------------------------------------------------------
  319.  
  320. [GHS 05/08/96]
  321.